-- *****************************************************************
-- CISCO-ITP-MONITOR-MIB: MIB for managing information for
-- ITP Monitor Probe
--
-- October 2003 John Linton, Shekhar Acharya
--
-- Copyright (c) 2003, 2004 by Cisco Systems, Inc.
-- All rights reserved.
-- *****************************************************************CISCO-ITP-MONITOR-MIB DEFINITIONS::=BEGINIMPORTSciscoMgmt
FROM CISCO-SMI
InetPortNumberFROM INET-ADDRESS-MIB
SnmpAdminStringFROM SNMP-FRAMEWORK-MIB
MODULE-COMPLIANCE,NOTIFICATION-GROUP,OBJECT-GROUPFROM SNMPv2-CONF
TruthValueFROM SNMPv2-TC
Counter32,Gauge32,Unsigned32,MODULE-IDENTITY,NOTIFICATION-TYPE,OBJECT-TYPEFROM SNMPv2-SMI;ciscoItpmMIB MODULE-IDENTITYLAST-UPDATED"200407200000Z"ORGANIZATION"Cisco Systems, Inc."CONTACT-INFO" Cisco Systems, Inc
Customer Service
Postal: 170 W. Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-ss7@cisco.com"DESCRIPTION
"The MIB for providing information related to
monitoring SS7 links.
This information can be used to manage the state
of software used to collect all packets transported
and received over a SS7 link.
Abbreviations:
MSU - Message Signalling Unit
MTP - Message Transport Protocol
SS7 - System No. 7 (SS7) Network"REVISION"200407200000Z"DESCRIPTION"Add support for notification when connection
to server changes states."REVISION"200310310000Z"DESCRIPTION"Initial version of this MIB module."::={ ciscoMgmt 379}--
-- Top-level structure of the MIBciscoItpmMIBNotifs OBJECTIDENTIFIER::={ ciscoItpmMIB 0}ciscoItpmMIBObjects OBJECTIDENTIFIER::={ ciscoItpmMIB 1}ciscoItpmMIBConform OBJECTIDENTIFIER::={ ciscoItpmMIB 2}cItpmConn OBJECTIDENTIFIER::={ ciscoItpmMIBObjects 1}cItpmLink OBJECTIDENTIFIER::={ ciscoItpmMIBObjects 2}
-- *************************************************************
-- * *
-- * Connection Table *
-- * *
-- *************************************************************cItpmConnTable OBJECT-TYPESYNTAXSEQUENCEOF CItpmConnTableEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This table provides information on connections used
to collect information on SS7 links. Information in
this table can be used to customize connection
parameters. In addition, this table provides
measurements and status information for each
connection."::={ cItpmConn 1}cItpmConnTableEntry OBJECT-TYPESYNTAX CItpmConnTableEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry in the cItpmConnTable table."INDEX{ cItpmConnPortNumber }::={ cItpmConnTable 1}
CItpmConnTableEntry ::=SEQUENCE{
cItpmConnPortNumber InetPortNumber,
cItpmConnKeepAlive Unsigned32,
cItpmConnMaxQDepth Unsigned32,
cItpmConnCongOnset Unsigned32,
cItpmConnCongAbate Unsigned32,
cItpmConnRcvWindowSize Unsigned32,
cItpmConnFastStart TruthValue,
cItpmConnQueueDepth Gauge32,
cItpmConnMonitorState INTEGER,
cItpmConnCongestion TruthValue,
cItpmConnCongCounts Counter32}cItpmConnPortNumber OBJECT-TYPESYNTAXInetPortNumberMAX-ACCESSnot-accessible
STATUScurrentDESCRIPTION"The port number used to establish TCP connection."::={ cItpmConnTableEntry 1}cItpmConnKeepAlive OBJECT-TYPESYNTAXUnsigned32(0..60000)UNITS"milliseconds"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Specifies the keepalive time value in milliseconds.
Keepalive packets are sent between the monitor and the
remote server as a mechanism to ensure the TCP session
is active and detect session failure in a timely manner.
During periods of idle monitor traffic, the monitor will
send a keepalive packet to the remote server at the
specified interval. The monitor also expects to receive
a keepalive packet from the remote server at the same
interval. If the monitor does not receive a
keepalive packet from the remote server in two times the
keep alive value, the monitor will close the TCP
session. The value of zero disables the keep alive
processing."DEFVAL{5000}::={ cItpmConnTableEntry 2}cItpmConnMaxQDepth OBJECT-TYPESYNTAXUnsigned32(10..100000)
UNITS"packets"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The maximum number of packets that can be queued for
transmission. If the monitor cannot send a TCP packet
immediately, the packet will be queued for retransmit.
This object defines the maximum number of TCP packets
that may be queued for retransmit. Once the number of
TCP packets on the queue reaches the value specified by
this object, additional TCP packets will be
dropped."DEFVAL{100}::={ cItpmConnTableEntry 3}cItpmConnCongOnset OBJECT-TYPESYNTAXUnsigned32(100..100000)UNITS"packets"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Threshold used to mark onset of congestion.
When the cItpmConnQueueDepth object reaches value
specified by this object the connection will
considered congested. It will remain congested until
the cItpmConnQueueDepth object drops below the value
specified by the cItpmConnCongAbate object."::={ cItpmConnTableEntry 4}cItpmConnCongAbate OBJECT-TYPE
SYNTAXUnsigned32(0..100000)UNITS"packets"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Threshold used to mark end of congestion.
When the cItpmConnQueueDepth object drops below the
value specified by this object the connection will
exit congestion."::={ cItpmConnTableEntry 5}cItpmConnRcvWindowSize OBJECT-TYPESYNTAXUnsigned32(100..1000000)
UNITS"bytes"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The size of TCP receive window. This object
defines the number of outstanding (unacknowledged)
bytes that the ITP monitor can receive on TCP
connection."DEFVAL{200000}::={ cItpmConnTableEntry 6}cItpmConnFastStart OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrent
DESCRIPTION"Defines the fast-start option for establishing TCP
connectivity as follows.
'true' - FastStart is enabled.
'false' - FastStart is disabled.
Normally, after the TCP session with the remote server
is established, the monitor will not send MSUs from the
monitored links to the server until the server responds
to the first keepalive.
This mechanism prevents the ITP from over-running the
server until the TCP session and receive window sizes
are fully established.
Configuration of fast-start overrides this mechanism and
allows the ITP to start sending MSUs to the server
immediately after the TCP session is established.
Caution should be used with the fast-start configuration
as MSUs may be lost until the TCP session server and
receive window sizes are fully established. "DEFVAL{ false }::={ cItpmConnTableEntry 7}cItpmConnQueueDepth OBJECT-TYPESYNTAXGauge32(0..100000)UNITS"packets"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of packets queued for transmission. The
maximum value is specified by the cItpmConnMaxQDepth
object."::={ cItpmConnTableEntry 8}
cItpmConnMonitorState OBJECT-TYPESYNTAXINTEGER{active(1),inactive(2)}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The state of the connection as follows.
'active' - connection is transmitting SS7 link
traffic to server.
'inactive' - connection is not transmitting SS7 link
traffic to server."::={ cItpmConnTableEntry 9}
cItpmConnCongestion OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Congestion indicator for connection as follows.
'true' - connection is congested.
'false' - connection not congested.
Congestion onset occurs when the cItpmConnQueueDepth
object reaches the maximum allowed value specified by
the cItpmConnMaxQDepth object.
Congestion abate occurs when the cItpmConnQueueDepth
object reaches the maximum allowed value specified by
the cItpmConnMaxQDepth object. "::={ cItpmConnTableEntry 10}cItpmConnCongCounts OBJECT-TYPE
SYNTAXCounter32UNITS"occurences"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of times the connection has entered
congestion."::={ cItpmConnTableEntry 11}-- *************************************************************
-- * *
-- * SS7 Links *
-- * *
-- *************************************************************cItpmLinkTable OBJECT-TYPESYNTAXSEQUENCEOF CItpmLinkTableEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This table provides information and measurements
on the monitored SS7 links per connection. This table
shares the cItpmConnPortNumber index with the
cItpmConnTable."::={ cItpmConn 2}cItpmLinkTableEntry OBJECT-TYPESYNTAX CItpmLinkTableEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry in the cItpmLinkTable table."INDEX{ cItpmConnPortNumber,-- Shared Index
cItpmLinkNumber
}::={ cItpmLinkTable 1}
CItpmLinkTableEntry ::=SEQUENCE{
cItpmLinkNumber Unsigned32,
cItpmLinkDescription SnmpAdminString,
cItpmLinkSlotNumber Unsigned32,
cItpmLinkStatus INTEGER,
cItpmLinkRcvdMsus Counter32,
cItpmLinkRcvdMsuDrops Counter32,
cItpmLinkRcvdMsuRate Gauge32,
cItpmLinkRcvdBitsRate Gauge32,
cItpmLinkSentMsus Counter32,
cItpmLinkSentMsuDrops Counter32,
cItpmLinkSentMsuRate Gauge32,
cItpmLinkSentBitsRate Gauge32}cItpmLinkNumber OBJECT-TYPESYNTAXUnsigned32(1..65535)MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This object specifies the secondary index for
objects in the cItpmLinkTable table. A unique
number is assigned to each link when it is
assigned to a connection."::={ cItpmLinkTableEntry 1}cItpmLinkDescription OBJECT-TYPESYNTAXSnmpAdminString(SIZE(0..128))MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Brief customer defined description."::={ cItpmLinkTableEntry 2}cItpmLinkSlotNumber OBJECT-TYPESYNTAXUnsigned32(0..32767)
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The slot number support interface used to collect
SS7 link traffic."::={ cItpmLinkTableEntry 3}cItpmLinkStatus OBJECT-TYPESYNTAXINTEGER{active(1),inactive(2)}MAX-ACCESSread-only
STATUScurrentDESCRIPTION"The state of the monitored SS7 Link as follows.
'active' - SS7 link is available for monitoring.
'inactive' - SS7 link is unavailable for monitoring."::={ cItpmLinkTableEntry 4}cItpmLinkRcvdMsus OBJECT-TYPESYNTAXCounter32UNITS"MSUs"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of MSUs received on SS7 Link."::={ cItpmLinkTableEntry 5}
cItpmLinkRcvdMsuDrops OBJECT-TYPESYNTAXCounter32UNITS"MSUs"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of MSUs that were received on SS7 Link
and were dropped due to congestion."::={ cItpmLinkTableEntry 6}cItpmLinkRcvdMsuRate OBJECT-TYPESYNTAXGauge32UNITS"MSUs per second"MAX-ACCESSread-only
STATUScurrentDESCRIPTION"The number of MSUs received on SS7 Link per second."::={ cItpmLinkTableEntry 7}cItpmLinkRcvdBitsRate OBJECT-TYPESYNTAXGauge32UNITS"bits per second"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of bits received on SS7 Link per second."::={ cItpmLinkTableEntry 8}cItpmLinkSentMsus OBJECT-TYPESYNTAXCounter32
UNITS"MSUs"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of MSUs sent on SS7 Link."::={ cItpmLinkTableEntry 9}cItpmLinkSentMsuDrops OBJECT-TYPESYNTAXCounter32UNITS"MSUs"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of MSUs that were sent on SS7 Link
and were dropped due to congestion."::={ cItpmLinkTableEntry 10}cItpmLinkSentMsuRate OBJECT-TYPESYNTAXGauge32UNITS"MSUs per second"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of MSUs sent on SS7 Link per second."::={ cItpmLinkTableEntry 11}cItpmLinkSentBitsRate OBJECT-TYPESYNTAXGauge32UNITS"bits per second"MAX-ACCESSread-only
STATUScurrentDESCRIPTION"The number of bits sent on SS7 Link per second."::={ cItpmLinkTableEntry 12}-- *************************************************************
-- * *
-- * Notification Enable Objects *
-- * *
-- *************************************************************cItpmCongestionNotifEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The ITP monitor congestion States notification
truth value.
'true' Indicates that cItpmCongestionNotifEnabled
notification is to be generated when the state
changes. That is, the notification generation
is enabled.
'false' Indicates that cItpmCongestionNotifEnabled
notification generation is disabled."DEFVAL{ false }::={ ciscoItpmMIBObjects 3}cItpmMonitorStateNotifEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrent
DESCRIPTION"The ITP monitor state notification truth value.
'true' - Indicates that ciscoItpMonitorState notification
is to be generated when the state of connection
changes. That is, the notification generation is
enabled.
'false' - Indicates that ciscoItpMonitorState notification
generation is disabled."DEFVAL{ false }::={ ciscoItpmMIBObjects 4}-- *************************************************************
-- * *
-- * Notifications *
-- * *
-- *************************************************************ciscoItpMonitorCongestion NOTIFICATION-TYPE
OBJECTS{ cItpmConnCongestion
}STATUScurrentDESCRIPTION"The notification generated when a connection
enters or exits congestion state. The value of
cItpmConnCongestion indicates new state."::={ ciscoItpmMIBNotifs 1}ciscoItpMonitorState NOTIFICATION-TYPEOBJECTS{ cItpmConnMonitorState
}STATUScurrentDESCRIPTION"The notification generated when a connection
changes states. The value of
cItpmConnMonitorState indicates new state."::={ ciscoItpmMIBNotifs 2}
-- *************************************************************
-- * *
-- * Conformance Information *
-- * *
-- *************************************************************ciscoItpmMIBCompliances OBJECTIDENTIFIER::={ ciscoItpmMIBConform 1}ciscoItpmMIBGroups OBJECTIDENTIFIER::={ ciscoItpmMIBConform 2}-- ********************************************************************
-- Compliance Statements
-- ********************************************************************
ciscoItpmMIBCompliance MODULE-COMPLIANCESTATUSdeprecated-- replaced by ciscoItpmMIBComplianceRev1DESCRIPTION"The compliance statement for entities which implement
the CISCO-ITP-MONITOR-MIB.my MIB"MODULE-- this moduleMANDATORY-GROUPS{
ciscoItpmConnGroup,
ciscoItpmLinkGroup,
ciscoItpmNotificationsGroup
}::={ ciscoItpmMIBCompliances 1}ciscoItpmMIBComplianceRev1 MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for entities which implement
the CISCO-ITP-MONITOR-MIB.my MIB"MODULE-- this moduleMANDATORY-GROUPS{
ciscoItpmConnGroupRev1,
ciscoItpmLinkGroup,
ciscoItpmNotificationsGroupRev1
}::={ ciscoItpmMIBCompliances 2}-- ****************************************************************
-- Units of Conformance
-- ****************************************************************ciscoItpmConnGroup OBJECT-GROUPOBJECTS{ cItpmCongestionNotifEnabled,
cItpmConnKeepAlive,
cItpmConnMaxQDepth,
cItpmConnCongOnset,
cItpmConnCongAbate,
cItpmConnRcvWindowSize,
cItpmConnFastStart,
cItpmConnQueueDepth,
cItpmConnMonitorState,
cItpmConnCongestion,
cItpmConnCongCounts
}STATUSdeprecated-- replaced by ciscoItpmConnGroupRev1DESCRIPTION"ITP Monitor connection group."::={ ciscoItpmMIBGroups 1}ciscoItpmLinkGroup OBJECT-GROUPOBJECTS{ cItpmLinkDescription,
cItpmLinkSlotNumber,
cItpmLinkStatus,
cItpmLinkRcvdMsus,
cItpmLinkRcvdMsuDrops,
cItpmLinkRcvdMsuRate,
cItpmLinkRcvdBitsRate,
cItpmLinkSentMsus,
cItpmLinkSentMsuDrops,
cItpmLinkSentMsuRate,
cItpmLinkSentBitsRate
}STATUScurrentDESCRIPTION"ITP Monitor SS7 Link group"::={ ciscoItpmMIBGroups 2}ciscoItpmNotificationsGroup NOTIFICATION-GROUPNOTIFICATIONS{ ciscoItpMonitorCongestion
}STATUSdeprecated-- replaced by ciscoItpmNotificationsGroupRev1DESCRIPTION"ITP Monitor notification objects."::={ ciscoItpmMIBGroups 3}ciscoItpmConnGroupRev1 OBJECT-GROUPOBJECTS{ cItpmCongestionNotifEnabled,
cItpmMonitorStateNotifEnabled,
cItpmConnKeepAlive,
cItpmConnMaxQDepth,
cItpmConnCongOnset,
cItpmConnCongAbate,
cItpmConnRcvWindowSize,
cItpmConnFastStart,
cItpmConnQueueDepth,
cItpmConnMonitorState,
cItpmConnCongestion,
cItpmConnCongCounts
}STATUScurrentDESCRIPTION"ITP Monitor connection group"::={ ciscoItpmMIBGroups 4}ciscoItpmNotificationsGroupRev1 NOTIFICATION-GROUPNOTIFICATIONS{ ciscoItpMonitorCongestion,
ciscoItpMonitorState
}STATUScurrent
DESCRIPTION"ITP Monitor notification objects."::={ ciscoItpmMIBGroups 5}END